home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / qp_120.zip / QP.DOC next >
Text File  |  1993-12-01  |  11KB  |  225 lines
  1. ▄▄▄▄▄▄▄▄▄       ▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄    Chris Jantzen
  2. █  ▄▄▄█ █▄▄▄▄▄▄▄█  ▄▄▄█▄▄▄█ ▄▄█ █▄   SlugSoft
  3. █▄▄▄  █ █ █ █ ▄ █▄▄▄  █ ▄ █ ▄█▄ ▄█┐  1880 Ocean Blvd. SE
  4. █▄▄▄▄▄█▄█▄▄▄█▄▄ █▄▄▄▄▄█▄▄▄█▄█│█▄█┌┘  Coos Bay, OR  97420-1911
  5.  └─────┴─┴──█▄▄▄█ ├────┴───┴─┘ └─┘   USA
  6.              └────┘                  FidoNet 1:356/18.2
  7.  
  8.  
  9.                                 QP v1.20
  10.  
  11.               Versatile DOS Text Mode Sound Module Player
  12.  
  13. Introduction
  14.  
  15. QP provides services for playing many different digital music modules
  16. out of several different output devices. QP uses the VangeliSTracker
  17. routines graciously provided by Juan Carlos Arévalo and company and as
  18. such can play StarTrekker 31 voice 4 channel .MOD ('FLT4'), ProTracker
  19. 31 voice 4 channel .MOD ('M.K.' and 'M!K!'), SoundTracker 15 voice 4
  20. channel .MOD, Triton Fast Tracker 6 or 8 channel .MOD, Grave Program
  21. .WOW, Oktalizer .OKT, Scream Tracker 2.x .STM, Scream Tracker 3.0 beta
  22. .S2M, Scream Tracker 3.0 .S3M, and Composer 669 .669 files. I have
  23. personally added support for the Play Sample From Offset, Note Cut, Note
  24. Delay, and Retrigger commands; fixed the .STM, .669, .S3M, and .MOD
  25. loader code; added a new quality level; and cleaned up code (a LOT).
  26.  
  27.                 ----------------------------------------
  28.  
  29. QP requires a VESA-compatible SVGA card capable of producing 132x43 text
  30. modes or better. If your card isn't VESA compatible (QP will tell you
  31. really quickly), the VESA commitee does provide a disk of drivers for
  32. common video cards. Try to get ahold of the drivers on your local BBS.
  33. New feature as of 1.10: You can put your card in a 132x43 mode (or
  34. higher) and QP will operate on screen without having to use VESA.
  35.  
  36.                 ----------------------------------------
  37.  
  38. The ProTracker/SoundTracker commands that QP cannot support include:
  39. Tremolo, Gliss Control, Vibrato Control, Fine Tune (and instrument fine
  40. tune values), Jump Loop (internal pattern jump), Tremolo Control,
  41. Pattern Delay, and Funk It (or Inverse Loop). Don't worry, though, the
  42. list of commands supported is longer and covers more than 99% of all
  43. existing .MOD files. (Also note that the unsupported commands are
  44. displayed in the Command pane on screen, but not executed.) There are
  45. also many unknown Scream Tracker 3.0 commands. I trying to contact
  46. Future Crew, and hope to be able to implement more commands. Most .S3M
  47. and .S2M files play pretty well, except for "World of Plastic" which
  48. apparently has some unknown key shift, note cut, and volume level
  49. commands and 2nd Reality in which the format has apparanetly by changed
  50. (entirely) to accomodate GUS and Surround support.
  51.  
  52.                 ----------------------------------------
  53.  
  54. The Bass Filter (supported in 1.10) can help a lot if you have those
  55. stinky little "computer speakers" that couldn't knock over a toothpick
  56. with bass if their lives were at stake. The Bass command (/BASS
  57. hereafter) reduces treble slightly and boosts the bass significantly
  58. (i.e., turns "tone" knob to left). It uses a dynamic linear digital
  59. filter (or something similar, I haven't analyzed Mr. Arévalo's filters
  60. that closely). This means that output is distorted significantly.
  61. However, this shouldn't make much of a difference on those dinky little
  62. speakers. (It also shouldn't make a difference if you're one of those
  63. people who craves nothing but BASS BASS BASS BASS.)
  64.  
  65.                 ----------------------------------------
  66.  
  67. If you have trouble loading a file or QP seems to load the file, but
  68. quits immediately back to DOS, then you may not have enough memory. Try
  69. freeing up more RAM or adjusting the quality level. The quality level is
  70. by default Normal, but as of 1.20 there are three different quality
  71. levels: Normal, Low, and Poor in order of descending quality. Use the /Q
  72. command to change the quality level like so:
  73.  
  74.         Normal Quality:
  75.                 QP file.mod
  76.  
  77.         Low Quality:
  78.                 QP file.mod /Q:L
  79.  
  80.         Poor Quality:
  81.                 QP file.mod /Q:P
  82.  
  83. The quality levels work by "deres"ing the samples. (ala Tron) At Low
  84. Quality all largish samples will be averaged and cut in half; at Poor
  85. Quality all largish samples will be averaged and cut in quarter. Thus,
  86. the samples use less RAM. This has the unfortunate side effect of
  87. decreasing the output quality (as if it wasn't bad enough already
  88. <smirk>). Poor Quality really sounds bad (almost but not quite as bad as
  89. PC Speaker output), but the song is still there.
  90.  
  91.                 ----------------------------------------
  92.  
  93. Shown below is a table of mixing speeds known to work rather well (i.e.,
  94. I have tested these configurations myself):
  95.  
  96. System Configuration                            Mixing speed    Channels
  97. 386DX/40 EMM386 Sound Blaster DMA               22000 Hz        16
  98. 386DX/40 EMM386 Sound Blaster DMA               44000 Hz        8
  99. 386DX/40 EMM386 Polled Modes                    22000 Hz        4
  100. 386DX/20 HIMEM Polled Modes                     16000 Hz        4
  101. 486SX/33 EMM386 Sound Blaster 16 DMA            44000 Hz        4 (maybe more)
  102. 386SX/20 EMM386 Sound Blaster 16 DMA            16000 Hz        4
  103.  
  104. (Note that reducing the mixing speed can increase the channels
  105. performance. Also, these speeds produce high-speed bar updates--higher
  106. speeds can be achieved by sacrificing screen speed. Also note that these
  107. tests were performed before piano roll was implemented. Cut most of
  108. these by 25% if piano roll is running on less than optimum [486]
  109. system.)
  110.  
  111.                 ----------------------------------------
  112.  
  113. This program is designed for the "power user". If you are uncomfortable
  114. at the DOS prompt, then this program might not for you. If you thrive at
  115. the DOS prompt, then this program may become one of your better friends.
  116. To learn about the program, study the help screen ('QP /?'), I'm afraid
  117. that's all the documentation available at this point.
  118.  
  119.  
  120. The Future
  121.  
  122. QP is a constantly expanding project (now, if only the EXE would stop
  123. doing that!), and I have several plans for future upgrades. If you have
  124. any nifty ideas, send them with your registration, or mail them to the
  125. address above.
  126.  
  127.  
  128. Kudos
  129.  
  130. Tim Van Over:   One of those all powerful influences in our area--he even
  131.                 bought me my first Turbo Pascal.
  132.  
  133. Mark Magill:    Sysop of The College BBS and general wonderful guy.
  134.  
  135. Juan Carlos Arévalo: For creating the wonderful VangeliSTracker routines
  136.                 and essentially placing them in the public domain.
  137.  
  138. Jesse Williamson: For having a video card that didn't support the same
  139.                 video modes as mine--causing me to write in flexible
  140.                 screen drawing routines.
  141.  
  142. Fabrice Bellard: For his wonderful LZEXE program, and especially for allowing
  143.                 developers to use it for free.
  144.  
  145. All you European Demo Dudes: I'd like to know you personally, but I
  146.                 don't (nudge, nudge)--keep those cool programs coming!
  147.  
  148. Anyone who took the time to read this (whew).
  149.  
  150. And especially YOU THE REGISTERED USERS (without whom I might not write
  151. this, or actually, without whom I appear to be writing this...).
  152.  
  153.  
  154. License
  155.  
  156. You, the user, have a license to use this program for 30 days after
  157. receiving the executables. After this trial period, you must register
  158. the program with SlugSoft (see below). You also have a license to copy
  159. and share the program freely as long as the package is shared in its
  160. entirety and no more than $10 is ever charged for its distribution.
  161.  
  162.  
  163. Disclaimer
  164.  
  165. SlugSoft and Chris Jantzen disclaim all warranties as to this software,
  166. whether express or implied, including without limitation any warranties
  167. of merchantability, fitness for a particular purpose, functionality or
  168. data integrity or protection.
  169.  
  170.  
  171. Registration
  172.  
  173. Registration is nice and easy, so PLEASE DON'T SKIP OVER THIS SECTION!
  174. To register this program, just send me a letter very clearly stating
  175. your name, address, and the current version you are using. That's it! It
  176. would also be nice if you wrote about how the wheather is where you're
  177. coming from, how much you like the program, new features you might like
  178. to see in the program, and other nice things. You will be assigned a
  179. serial number for the program, but if you want to know what it is you
  180. need to send a self-addressed stamped envelope along with your letter.
  181.  
  182. If you are using this program in a commercial, government, or
  183. educational environment, I would like to restate that I am not
  184. responsible for what this program does on your machine (although I will
  185. try to help if it doesn't seem to work right). I would also like to ask
  186. that along with your letter you send some information, brochures, etc.
  187. on what your company/department/institution does. I cannot help you if
  188. you need help with special paperwork (such as P.O.'s).
  189.  
  190. Note, however, that although I don't actually ask for anything for
  191. registration, you won't actually really receive anything for your
  192. registration. You will, however, feel good about yourself, and if you
  193. send that SASE with your letter, I'll send some some heartfelt thanks
  194. along with your serial number.
  195.  
  196. All donations joyfully accepted.
  197.  
  198.  
  199. Notes
  200.  
  201. If you are running under a DOS version less than 3.0, then QP may
  202. have trouble finding itself (and it's internal overlay if the version
  203. you are using has such). QP will look in the PATH (starting in the
  204. current directory) and then try the QP environment variable. To set
  205. QP's path using the environment variable, type SET QP=C:\UTILS\
  206. from the DOS prompt (if C:\UTILS\ is where you keep QP). Substitute
  207. the path to QP for C:\UTILS\ above. (Trailing backslash is not
  208. necessary, but doesn't harm things.)
  209.  
  210. If you experience trouble running QP on a 386, set the environment
  211. variable NO386 to anything (e.g., SET NO386=Y) to disable 386
  212. instructions. (For example, it is known that older versions of QEMM will
  213. corrupt the 32-bit registers and cause irregular program behavior.) If
  214. you experience trouble running it on a non-386, you may also want to try
  215. disabling 386 instructions, just in case the CPU detection routines
  216. think your CPU is an 80386 (for some strange reason).
  217.  
  218.  
  219. Other copyrights, trademarks, and patents
  220.  
  221. References to programs other than QP and other SlugSoft programs
  222. without their respective copyright, trademark, or patent notices are not
  223. meant to be construed as challenges to such programs' copyright,
  224. trademark, and/or patent statuses.
  225.